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FILE REFERENCING 


The use of filespec means “tile specification”, and describes the 
variations in which file names, file types, and disk drive names 
can be included in a CP/M command string. Specific file names 
and file types (extensions) or wildcards can be specified. 


Format x:filename. ext 


x = Disk drive name (A:-B:, CP/M 1.3; 
A:-D:, CP/M 1.4; A:-P:, CP/M 2.0/2.2) 

Filename =Name of file (1 to 8 characters) 

ext =Extension or file type (optional or 1 to 3 
characters. 


BUILT-IN COMMANDS 


x: Make drive x: the logged drive 

DIR List all files on logged disk. 

DIR x: List all files on drive x: 

DIR filespec List al files specified by flespec, 

REN newname.ext=oldname.ext Rename file oldname.ext to 
newname.ext, 

REN x:newname.ext= oldname.ext oldname.ext is on drive x: 

ERA filespec Erase file(s) specified within filespec. 

TYPE filespec Display on console contents of filespec. 

USER x Select disk “user” area x (x=0-15), 
(CP/M 2.0/2.2 only.) 

SAVE n filespec Save n memory pages starting from location 
0100H into filespec. A “Memory Page” =256 bytes. 


CONTROL CHARACTER COMMANDS: Control character com- 
mands are entered by simultaneously pressing the CTRL key 
and the indicated key on the console device. 


CTRL/C Warm Boot 

CTAL/E Let long command string overtlow on next line. 

CTRL/H Backspace 

CTRL/I Tab cursor right 8 spaces. 

CTRL/J Line Feed. 

CTRL/M Carriage Return 

CTRL/U Cancel current command string. 

CTAL/X Same as CTRL/U (CP/M 1.4), and arase line 
(CP/M 2.0/2.2) 

CTRL/A Retype edited command string on next line, and omit all 
echoed characters deleted with DELETE or RUBOUT Key. 

CTRL/S Stop/Restart scrolling of text on console device 

CTRL/P Echo all console device input and output on the LST: 
printer device. 

CTRL/Z End console input (ED and PIP commands). 

DELETE or RUBOUT Delete character to left, and echo deleted 
character. i 


STAT COMMAND 


STAT Show amount of tree space on default drive. (Free space of 
every drive to which a read operation was made will also 
be shown.) 

STAT x; Show amount of free space on drive x:, 

STAT filespec Show size in records, kilobytes, and extents ot 
file(s) in filespec. In CP/M 2.0/2.2, R/W-R/O and DIR- 
SYS status is also shown. 

STAT filespec $R/O Set file(s) to Read-Only. 

STAT filespec SR/W Set file(s) to Read/Write. 


STAT x: =R/0 Temporarily set disk x: to Read-Only. 

STAT filespec $SYS Set file(s) to System file(s). (CP/M 2.0/2.2) 

STAT filespec SDIR Set file(s) to Directory file(s). (CP/M 
2.0/2.2). 

STAT USR: Show current USER number and numbers containing 
files (CP/M 2.0/2.2). 

STAT DSK: Show characteristics of disk in default drive. 

STAT x:DSK: Show characteristics of disk in drive x 

STAT DEV: Show current physical-to-ogical device assignments. 

STAT VAL: Show information on allowed device assignments and 
other STAT commands. 

STAT log: = phy: Assign physical device phy: to logical device 
log:, where device assignments can be: 


Logical Physical 
CON: = T1V:, ORT:, BAT:, or UOT 
ROR: TTY:, PTR:, UR1:, or UR2: 
PUN: TTY:, PTP:, UP1:, or UP2: 


LST: = TTV:, CRT:, LPT:, or ULI 


PIP COMMAND 


PIP Load PIP to perform individual copy operations. Press the 
RETURN key to exit when finished, 
PIP y: = x:filespec Copy file(s) from disk drive x: to disk drive 


E 

PIP y:new.ext=x:oid.ext Copy file old.ext on disk x: into tile 
new.ext on disk y:. 

new.ext=x:oid1.ext,old2.ext, ,. . Copy all files on disk 
x: in the order shown, into file new.ext on disk y: 

PIP DEV: =filespec Copy filespec to device DEV:, which can be 
any predefined standard logical or physical device (except 
BAT:). Special PIP logical devices OUT: (for output-only 
device) and PRN: (tor printer device) can also be used 

PIP filespec = DEV: Copy input from device DEV: into filespec 
uniti CTRL/Z is entered. Standard console and input-only 
devices may be used, as well as special PIP INP: device 
(input-only device). 

PIP PUN: = NUL: Send a null leader and/or 

PIP PUN: = NUL: flespee a trailer while copying 

PIP PUN: =NUL:,flespec, NUL: fllespec to the output- 

PIP PUN: =filespec,NUL: only device 

PIP PUN: =filespec, EOF: Send an end-of-file marker while 
copying filespec to the output-only device 


PIP 


OPTIONAL PIP PARAMETERS 


IV] Verity accuracy of copied data. 

[E] Echo (display) text on console while being copied. 

{Sstring^Z] Begin copying after text in string is found 
(terminate string with CTRL/Z). 

[string”2} Quit copying after text in string is found (terminate 
siring with CTRL/Z}. 

[L] Convert characters to lower case during copying. 

[U] Convert characters to upper case during copying. 

[Dn] Delete all characters on each line of text after column n 
during copying 

{Tn} Convert all ASCII tab characters to n number of spaces 
during copying 

[F] Delete all form-feed characters during copying 

[Pn] Insert form-feed characters after each n number of lines 
during copying 


IN] Add sequential line numbers without leading zeros to text 
during copying 

{N2] Same as [N] but with leading zeros. 

IR] Copy a System file (CP/M 2.0/2.2) 

IW] Copy over the destination file if it is read-only (CP/M 
2.0/2.2). 

[Gn] Copy from USER number n (0 to 15) to the current USER 
number (CP/M 2.0/2.2). 

10] Interpret file(s) being copied as containing non-ASCII 
object machine code. 

[B] Specity "Block Mode” format during copying between 
input-only and output-only devices. 

[I] ignore any Null Records in Intel Hexadecimal format during 
copying. 

IZ] Set parity bit of all bytes being copied to zero. 


ED COMMAND 


ED tilespec Load ED into memory and open filespec for 
creation and/or editing. 

ED Subcommands: The appearance of " ^Z” in a command 
string means the CTRL/Z command is used. "CP" means 
ED's Character Pointer. 

nA Append n text lines from source file to buffer. 

DA Append all text lines or until buffer is halt full 

#A Append all text lines or until buffer is full 

1 Enter insert mode until CRL/Z is entered. 

ext Enter insert mode until a CTRL/Z is entered, and insert 
text 

textZ Enter insert mode, insert text, and exit. 

U Engage character translation to upper case. 

=U Disengage character translation to upper case. 

nC Move CP n characters to right 

nC Move CP n characters to left. 

nL Move CP n lines forward 

—nL Move CP n tines back. 

V Engage displaying of line numbers. 

-V Disengage displaying of line numbers 

n: Move CP to line number n: 

B Move the CP to beginning of butter. 

—B Move the CP to end of buffer. 

T Display text on current line before CP. 

OT Display text on current line after CP. 

OTT Display all text on current line. 

‘AT Display n tines after CP, 

=nT Display n lines before CP. 

#7 Display all lines after the CP. 

AT Display all lines before the CP. 

nP Move CP n pages forward 

—nP Move GP n pages back 

nD Delete n characters after CP. 

— nD Delete n characters before CP. 

nK Kili (delete) n lines after CP. 

— nK Kill (delete) n lines before CP. 

Ftext\Z Find text string in text in the butter 

nFtext^Z As above except find n'th occurrence of text, 

Ntext^ Z Same as the F command, except perform nNtext ^Z 
automatic append operations from source file as necessary. 

Stind^ Zreplace^Z Search tor text in find and replace it with 
replace text string. 

nStindAZreplace ^Z Same as S command except find n'th 
occurrence of find text string. 


Jtind^ Zinsert^Zend^Z Find find string, insert insert string 
after find (jutxtaposition), and delete all text thereafter until 
end string is found. 

nJtind^ Zinsert^Zend^Z As above except find n'th occurrence 
of find 

nMcommands Specify *macro” repetition of group of 
commands (commands), n number of times. 

OV Display total butter usage and free space. 

W Write current line to the temporary output file. 

nW Write n lines to temporary output file. 

OW Write lines until buffer is halt empty. 

AW Write all lines until buffer is completely empty. 

nX Write n lines to a temporary library file. 

A Read entire contents of temporary library file (created by 
aX") into buffer. 

Afilename Read library file filename. LIB into butter. 

H Save all editing in final output file without exiting ED. 

E Exit ED and save all editing in final output file. 

0 Erase all editing in butfer and final output file without exiting 
ED. 

Q Exit ED and erase all editing in buffer and final output file. 


SUBMIT AND XSUB COMMANDS 


SUBMIT filename a b ¢ ... Load SUBMIT command and 
“submit” commands stored in filename. SUB to CP/M, and 
make optional text substitutions of $1, $2, $3, etc. stored 
in filename with a, b c, etc., respectively. 

XSUB (Extended SUBMIT Program): This program is available 
only in CP/M 2.0/2.2, and is placed in a SUBMIT file to 
permit the submitting of entries to other programs loaded 
by SUBMIT, XSUB may not be entered by itself on the 
command line. 


ASM COMMAND 


ASM filename.123 Load the CP/M 8080 Assembier and 
assemble filename, ASM with optional parameters 123 as 
follows: 1 = 1st parameter position where drive name 
stored with filename.ASM can be specified, 2 = 2nd 
parameter position where drive name to which 
filename, HEX is to be output can be specified. 3= 3rd 
parameter position where drive name to which 
filename. PRN is to be output can be specified. In either 
the 2nd or 3rd positions you can specify "2" for no output, 
or in the 3rd position, ”X” to send output to console 
device, 


LOAD COMMAND 


LOAD filename Read filename (with extension .HEX (created 
with ASM command)), and create executable command file 
filename (with extension .COM). 


DDT COMMAND 


DOT Load DDT (Dynamic Debugging Tool), and 

DDT tilespec optionally place filespec into memory. 

DDT Subcommands: (“hex" means hexadecimal (base 16) 
numbers; and “loc” means a hex memory location.) 


D Display next 192 loc. from current oc. 

Dstart Same as above but display from start loc. 

Dstart,end Same as above but display until end loc. is 
reached. 

Fotart,end,data Fill all loc, between loc. start and end, with 
data (in hex). 

Iilespec Insert and establish File Control Block (FCB) of 
filespec so file can subsequently be read into memory with 
the R command. 

R Read the contents of filespec (specified by | command) into 
memory starting at current loc 

Restart Same as above, but read into memory starting at loc. 
stat 

L List next 192 loc. from current loc. in assembly language 
format. 

Lstart Same as above but list next 192 loc. from start loc. 

Lstart,end Same as above but list all loc. between start and 
‘end loc. 

Sstart Display and optionally change hex contents of loc. 
start, and subsequent loc. until ".” is entered 

Astart Insert assembly language statements starting at location 
start, and continue with subsequent locations until *.” is 
entered. 

Mstartt endt,start2 Copy contents of specific memory block 
between loc. startt and endi to another block in memory 
starting at loc. start2 

G Execute program in memory with no breakpoints. 

Gstart Same as above, starting at loc. start. 

Gstart,end Same as above, with breakpoint at loc, end, 

Gstart,ond1,end2 Same as above, with two breakpoints at loc. 
endi and end2. 

id Same as above but start at current lc. 

end end? 

Unumber Execute number program instructions and stop to 
display contents of CPU registers, 

Tnumber Trace execution of number program executions, 
displaying contents of CPU registers for each instruction 

X Display contents of all CPU registers. 

Xragister Display contents of CPU register register. 


DUMP COMMAND 

DUMP filespec Dump contents of filespec to the console in 
hexadecimal format, 

SYSGEN COMMAND 


SYSGEN Initiate the SYSGEN dialog. 
SYSGEN filespec Retrieve system image stored in filespec on 


Oe ee 


MOVCPM nn # Same as above, but do not transfer control, and 
Prepare system image for saving in a file. 

NOTE: When using “MOVCPM # #” or *MOVCPM nn 

system image will be left in memory, and the SAVE command 

is subsequently used to save it on a disk. The SYSGEN com- 

mand can then be used to generate a bootable system image. 


NOTES: 


disk 


MOVCPM COMMAND 


MOVCPM Move system using all available memory and transter 
and transter control to it when finished. 

MOVCPM # # Same as above, but do not transfer control, and 
prepare system image for saving in a file 

MOVCPM nn Move system using nn kilobytes of memory and 
transfer control to it when finished. 


